中文 | English

Slash commands 让你可以用快速、键盘优先的方式控制 Codex。在输入框中键入 / 即可打开 slash 弹窗，选择某个命令后，Codex 就会执行诸如切换模型、调整权限，或在不离开终端的情况下总结长对话之类的操作。

本指南将向你展示如何：

• 为任务找到合适的内置 slash command
• 使用 /model、/fast、/personality、/permissions、/agent 和 /status 等命令来引导一个活动中的会话

内置 slash commands

Codex 自带以下命令。打开 slash 弹窗后，开始输入命令名即可过滤列表。

Command	Purpose	When to use it
/permissions	设置 Codex 在不先询问的情况下能做什么。	在会话中途放宽或收紧审批要求，例如在 Auto 与 Read Only 之间切换。
/sandbox-add-read-dir	为额外目录授予沙箱读权限（仅 Windows）。	解除那些需要读取当前可读根目录之外的绝对目录路径的命令阻塞。
/agent	切换当前活动的 agent 线程。	检查或继续某个已生成 subagent 线程中的工作。
/apps	浏览 apps（connectors）并将其插入到你的 prompt 中。	在请求 Codex 使用某个 app 之前，将其作为 $app-slug 附到 prompt 中。
/clear	清空终端并开始一段新聊天。	当你想要一个全新的起点时，同时重置可见 UI 和对话。
/compact	总结当前可见对话以释放 tokens。	长时间运行后使用，让 Codex 保留关键点而不撑爆上下文窗口。
/copy	复制最近一次已完成的 Codex 输出。	无需手动选择即可获取最近一次完成的响应或计划文本。
/diff	显示 Git diff，包括 Git 尚未跟踪的文件。	在提交或运行测试前检查 Codex 所做的修改。
/exit	退出 CLI（与 /quit 相同）。	另一种写法；两者都会退出当前会话。
/experimental	切换实验性功能。	在 CLI 中启用 subagents 等可选功能。
/feedback	向 Codex 维护者发送日志。	向支持团队报告问题或分享诊断信息。
/init	在当前目录生成一个 AGENTS.md 脚手架。	为你当前工作的仓库或子目录记录持久化说明。
/logout	退出 Codex 登录。	在共享机器上清理本地凭据。
/mcp	列出已配置的 Model Context Protocol（MCP）工具。	检查 Codex 在当前会话中可以调用哪些外部工具。
/mention	将一个文件附加到对话中。	明确告诉 Codex 你希望它下一步检查哪些特定文件或文件夹。
/model	选择当前活动模型（以及可用时的推理强度）。	在执行任务前，在通用模型（gpt-4.1-mini）与更强推理模型之间切换。
/fast	为 GPT-5.4 切换 Fast mode。	打开或关闭 Fast mode，或检查当前线程是否正在使用它。
/plan	切换到 plan mode，并可选地发送一个 prompt。	在真正开始实现前，要求 Codex 先提出执行计划。
/personality	选择响应的沟通风格。	无需修改你的指令，就能让 Codex 更简洁、更具解释性或更协作。
/ps	显示实验性的后台终端及其最近输出。	无需离开主转录界面，就能查看长时间运行命令的状态。
/fork	将当前对话 fork 成一个新线程。	在不丢失当前转录内容的前提下，分叉当前会话去探索另一种做法。
/resume	从 session 列表恢复一段已保存的对话。	无需从头开始，就能继续之前的 CLI 会话中的工作。
/new	在同一个 CLI 会话中开始一段新对话。	在同一仓库中重置聊天上下文，而无需退出 CLI。
/quit	退出 CLI。	立即离开当前会话。
/review	要求 Codex 审查你的工作树。	当 Codex 完成工作后，或你希望对本地改动再做一轮检查时使用。
/status	显示 session 配置与 token 使用情况。	确认当前模型、审批策略、可写根目录以及剩余上下文容量。
/debug-config	打印配置层与 requirements 的诊断信息。	调试优先级与策略要求，包括实验性的网络约束。
/statusline	交互式配置 TUI 状态栏字段。	选择并重新排序底部项目（model/context/limits/git/tokens/session），并将其持久化到 config.toml。

/quit 与 /exit 都会退出 CLI。只有在你已经保存或提交了重要工作之后才应使用它们。

/approvals 命令仍然可以作为别名使用，但它不再出现在 slash 弹窗列表中。

使用 slash commands 控制你的会话

下面这些工作流可以让你的会话保持在正确轨道上，而无需重启 Codex。

使用 /model 设置当前模型

1. 启动 Codex 并打开输入框。
2. 输入 /model 并按回车。
3. 在弹窗中选择模型，例如 gpt-4.1-mini 或 gpt-4.1。

预期结果：Codex 会在转录中确认新的模型。运行 /status 可验证变更。

使用 /fast 切换 Fast mode

1. 输入 /fast on、/fast off 或 /fast status。
2. 如果你希望该设置持久化，请在 Codex 提示保存时确认更新。

预期结果：Codex 会报告当前线程的 Fast mode 是开启还是关闭。你也可以通过 /statusline 在 TUI 页脚中显示一个 Fast mode 状态项。

使用 /personality 设置沟通风格

使用 /personality，可以在不重写 prompt 的情况下改变 Codex 的沟通方式。

1. 在一个活动对话中输入 /personality 并按回车。
2. 从弹窗中选择一种风格。

预期结果：Codex 会在转录中确认新的风格，并在该线程后续响应中使用它。

Codex 支持 friendly、pragmatic 与 none 三种 personality。使用 none 可禁用 personality instructions。

如果当前模型不支持 personality-specific instructions，Codex 会隐藏该命令。

使用 /plan 切换到 plan mode

1. 输入 /plan 并按回车，将当前对话切换到 plan mode。
2. 可选：提供内联 prompt 文本（例如 /plan Propose a migration plan for this service）。
3. 在使用内联 /plan 参数时，你也可以粘贴内容或附加图片。

预期结果：Codex 进入 plan mode，并使用你可选提供的内联 prompt 作为第一条规划请求。

当某个任务已经在运行时，/plan 会暂时不可用。

使用 /experimental 切换实验性功能

1. 输入 /experimental 并按回车。
2. 切换你想要的功能（例如 Apps 或 Smart Approvals），然后如果提示要求重启 Codex，就执行重启。

预期结果：Codex 会把你的功能选择保存到配置中，并在重启后生效。

使用 /clear 清空终端并开始新聊天

1. 输入 /clear 并按回车。

预期结果：Codex 会清空终端、重置可见转录内容，并在同一个 CLI 会话中开始一段新聊天。

与 Ctrl + L 不同，/clear 会开始一段新对话。

Ctrl + L 只会清空终端视图，并保留当前聊天。当任务正在进行时，Codex 会禁用这两种操作。

使用 /permissions 更新权限

1. 输入 /permissions 并按回车。
2. 选择与你的舒适度相匹配的审批预设，例如 Auto（适合放手运行）或 Read Only（适合查看改动）。

预期结果：Codex 会宣布更新后的策略。后续动作都会遵循新的审批模式，直到你再次修改它。

使用 /copy 复制最近一次响应

1. 输入 /copy 并按回车。

预期结果：Codex 会将最近一次已完成的 Codex 输出复制到你的剪贴板。

如果某一轮仍在运行中，/copy 会使用最近一次已完成的输出，而不是正在进行中的响应。在第一次完成的 Codex 输出出现之前，以及刚刚回滚之后，此命令不可用。

使用 /sandbox-add-read-dir 授予沙箱读权限

此命令仅在原生 Windows CLI 中可用。

1. 输入 /sandbox-add-read-dir C:\absolute\directory\path 并按回车。
2. 确认该路径是一个已存在的绝对目录。

预期结果：Codex 会刷新 Windows 沙箱策略，并为后续在沙箱中运行、且需要读取该目录的命令授予读权限。

使用 /status 检查 session

1. 在任意对话中输入 /status。
2. 查看输出中的活动模型、审批策略、可写根目录和当前 token 使用情况。

预期结果：你会看到类似于 shell 中 codex status 打印出的摘要，从而确认 Codex 正在你预期的位置和模式下运行。

使用 /debug-config 检查配置层

1. 输入 /debug-config。
2. 查看输出中的配置层顺序（从最低优先级开始）、启用/禁用状态以及策略来源。

预期结果：Codex 会打印层级诊断信息，以及诸如 allowed_approval_policies、allowed_sandbox_modes、mcp_servers、rules、enforce_residency 和 experimental_network 等策略细节（如果已配置）。

使用这些输出，可以调试为什么最终生效的设置与 config.toml 不一致。

1. 输入 /statusline。
2. 使用选择器切换并重新排序各个项目，然后确认。

预期结果：页脚状态栏会立即更新，并持久化到 config.toml 中的 tui.status_line。

可用的状态栏项目包括模型、模型加推理信息、上下文统计、限流、git 分支、token 计数器、session id、当前目录/项目根目录，以及 Codex 版本。

使用 /ps 检查后台终端

1. 输入 /ps。
2. 查看后台终端列表及其状态。

预期结果：Codex 会显示每个后台终端的命令，以及最多三行最近的非空输出，便于你快速判断进展。

当 unified_exec 生效时，后台终端才会出现；否则，该列表可能为空。

使用 /compact 保持转录精简

1. 在长时间对话后，输入 /compact。
2. 当 Codex 提议总结到目前为止的对话时，确认即可。

预期结果：Codex 会用一份简洁摘要替换先前的多轮对话，在保留关键信息的同时释放上下文。

使用 /diff 检查变更

1. 输入 /diff 以查看 Git diff。
2. 在 CLI 中滚动查看输出，检查修改和新增文件。

预期结果：Codex 会显示你已暂存的修改、尚未暂存的修改，以及 Git 尚未开始跟踪的文件，帮助你决定保留哪些内容。

使用 /mention 高亮文件

1. 输入 /mention 后跟路径，例如 /mention src/lib/api.ts。
2. 从弹窗中选择匹配结果。

预期结果：Codex 会把该文件添加到对话中，从而确保后续轮次直接引用它。

使用 /new 开始新对话

1. 输入 /new 并按回车。

预期结果：Codex 会在同一个 CLI 会话中开始一段新对话，这样你就可以在不离开终端的情况下切换任务。

与 /clear 不同，/new 不会先清空当前终端视图。

使用 /resume 恢复已保存的对话

1. 输入 /resume 并按回车。
2. 从已保存 session 的选择器中选择你要恢复的会话。

预期结果：Codex 会重新加载所选对话的转录内容，让你可以从上次结束处继续，同时保留原始历史。

使用 /fork 分叉当前对话

1. 输入 /fork 并按回车。

预期结果：Codex 会将当前对话复制到一个带有新 ID 的线程中，原始转录保持不变，因此你可以并行探索另一种方案。

如果你需要分叉的是某个已保存 session 而不是当前会话，请在终端中运行 codex fork 以打开 session 选择器。

使用 /init 生成 AGENTS.md

1. 在你希望 Codex 查找持久说明的目录中运行 /init。
2. 查看生成的 AGENTS.md，然后根据你的仓库约定进行编辑。

预期结果：Codex 会创建一个 AGENTS.md 脚手架，你可以进一步完善并提交，供后续会话使用。

使用 /review 请求工作树审查

1. 输入 /review。
2. 如果你还想检查具体的文件变更，可继续执行 /diff。

预期结果：Codex 会总结它在你的工作树中发现的问题，重点关注行为变化与缺失的测试。它会使用当前会话模型，除非你在 config.toml 中设置了 review_model。

使用 /mcp 列出 MCP 工具

1. 输入 /mcp。
2. 查看列表以确认当前会话中有哪些 MCP servers 和 tools 可用。

预期结果：你会看到 Codex 在本次会话中可以调用的已配置 Model Context Protocol（MCP）工具。

使用 /apps 浏览 apps

1. 输入 /apps。
2. 从列表中选择一个 app。

预期结果：Codex 会将 app 引用以 $app-slug 的形式插入到输入框中，随后你就可以立刻请求 Codex 使用它。

使用 /agent 切换 agent 线程

1. 输入 /agent 并按回车。
2. 从选择器中选中你想切换到的线程。

预期结果：Codex 会切换当前活动线程，以便你检查或继续该 agent 的工作。

1. 输入 /feedback 并按回车。
2. 按提示决定是否包含日志或诊断信息。

预期结果：Codex 会收集所请求的诊断信息，并将其提交给维护者。

使用 /logout 退出登录

1. 输入 /logout 并按回车。

预期结果：Codex 会清除当前用户会话的本地凭据。

使用 /quit 或 /exit 退出 CLI

1. 输入 /quit（或 /exit）并按回车。

预期结果：Codex 会立即退出。请先保存或提交任何重要工作。